Skip to main content

Registrar Doctores vía API

Autenticación​

Este endpoint permite crear doctores asociados a su Centro Médico. Para comenzar a crear doctores, primero debes obtener un token de autenticación. Realiza una solicitud POST al siguiente endpoint, según tu entorno:

👨🏻‍💻 Entorno de desarrollo:

POST https://api-dev.speaknosis.com/api/iam/integration/token

🏥 Entorno de producción:

POST https://api-prod.speaknosis.com/api/iam/integration/token

Ejemplo de cuerpo de la solicitud (application/x-www-form-urlencoded):

grant_type=client_credentials&client_id=client_id&client_secret=client_secret

Ejemplo con código (JavaScript):

const loginDataObject = new URLSearchParams({
  grant_type: "client_credentials",
  client_id: "client_id",
  client_secret: "client_secret",
});

const requestOptions = {
  method: "POST",
  headers: {
    "Content-Type": "application/x-www-form-urlencoded",
  },
  body: loginDataObject,
};

Recuerda reemplazar "client_id" y "client_secret" con tus credenciales otorgadas.

La respuesta exitosa (Código 200 OK) contendrá el access_token de acceso en formato JSON:

{
  "access_token": "",
  "token_type": "Bearer"
}

Creación de doctores​

Una vez autenticado, puedes proceder a registrar doctores realizando una solicitud POST al siguiente endpoint, según tu entorno:

👨🏻‍💻 Entorno de desarrollo:

POST https://api-dev.speaknosis.com/iam/v1/register/healthProviderDoctor

🏥 Entorno de producción:

POST https://api-prod.speaknosis.com/iam/v1/register/healthProviderDoctor

Ejemplo de cuerpo de la solicitud (application/json):

{
    "name": "Nombre", // Nombre del doctor.
    "lastname": "Apellido", // Apellido del doctor.
    "email": "[email protected]", // (Opcional) Correo electrónico del doctor con formato válido.
    "doctorId": "23120127", // ID del doctor en el sistema del cliente. Este ID puede ser el mismo que utilizan internamente.
    "healthProviderId": 1, // Este ID (healthProviderId) es proporcionado por Speaknosis. Contacte con nuestro equipo de soporte si es que todavía no se ha proporcionado.
    "doctorSpeciality": 1, // ID de la especialidad del doctor.
    "lang": "ES", // Código de idioma del doctor (Ej: ES para español, EN para inglés, CA para catalán).
    "doctorDictionary": "Paracetamol, Lóbulo Frontal, etc." // (Opcional) Palabras clave o términos relacionados con el doctor, separados por comas.
}

Para rellenar el campo de doctorSpeciality se debe consultar el listado de especialidades de Speaknosis para ver las especialidades disponibles y sus respectivos IDs.

La respuesta exitosa (Código 200 OK) contendrá la siguiente respuesta en formato JSON:

{
  "success": true,
  "message": "Doctor registrado exitosamente",
  "doctorId": "20" // ID del doctor registrado.
}

A partir de este momento, ya puede utilizar el doctorId generado para empezar a crear informes dentro de Speaknosis.